home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 12 / Cream of the Crop 12 (Part II) / Cream of the Crop 12 (Part II).iso / BBS / UULOG101.ZIP / UULOGIN.DOC < prev    next >
Encoding:
Text File  |  1996-01-28  |  12.7 KB  |  307 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                           ┌────────────────────────────────────────┐
  21.                           │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  22.                           │                                        │
  23.                           │                       uuLogin Ver 1.00 │
  24.                           │                                        │
  25.                           │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  26.                           └────────────────────────────────────────┘
  27.  
  28.                                 Chris Stone & High Mountain Software
  29.                       Copyright (C) 1995 - 1996  All Rights Reserved
  30.                                                         January 1996
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.     ┌ PRELIMINARIES ───────────────────────────────────────────────┐
  39.     └──────────────────────────────────────────────────────────────┘
  40.     You use this software  entirely  at  your own risk.   The author
  41.     and/or distributors are not responsible for any loss  or  damage
  42.     as   a   result   of   using  this  product  and  will  take  no
  43.     responsibility,  consequential or  otherwise  for use,  abuse or
  44.     misuse.
  45.  
  46.  
  47.     ┌ VERSIONS ────────────────────────────────────────────────────┐
  48.     └──────────────────────────────────────────────────────────────┘
  49.     uuLogin  is offered in two  flavours:   the  shareware  version,   
  50.     and  the registered  version.  The latter  contains  all  of the 
  51.     features documented in this manual,  whereas the former may lack  
  52.     several of these features. Wherever possible this is highlighted  
  53.     in the manual. If you use the shareware version, please read the
  54.     accompanying  notes which  detail fully  the differences between 
  55.     it and the registered release.  The presence of the registration
  56.     number unlocks the shareware version, making the  program run as 
  57.     the registered version.
  58.  
  59.     The author would have liked to release the full-featured version  
  60.     as shareware, but realizes  though that providing  no  incentive  
  61.     to register  almost  guarantees  that there  will be a very  low  
  62.     number of registration. If you possess the shareware version and 
  63.     you use this  product regularly and  wish to  continue using it, 
  64.     then please support the shareware concept and reward his effort. 
  65.     The further development  of  this  product,   including  several 
  66.     significant enhancements  and   the release  of other  shareware  
  67.     products is dependant on the number of  registrations  received!   
  68.     Feel free to  pass on a  copy of the  shareware  version to your 
  69.     friends, or upload it in its original form to any  public access 
  70.     bulletin board system.  
  71.  
  72.     If the version you possess is the  registered one, then you  are   
  73.     expressly   forbidden  from  copying  it  and distributing it to 
  74.     others in any  form. Your license is to use this software at one 
  75.     location. Your registered  key number  may not be  given in  any
  76.     form to any other person!
  77.  
  78.  
  79.     ┌ ABOUT UULOGIN ───────────────────────────────────────────────┐
  80.     └──────────────────────────────────────────────────────────────┘
  81.     uuLogin is a utility that allows a system operator  using any of
  82.     the popular frontend fido-style mailers to accept  incoming uucp
  83.     calls from remote systems. This program has been tested with the
  84.     following mailers: InterMail, dBridge, and FrontDoor. Any mailer
  85.     that allows you to define an  external mail call  handler should
  86.     work fine with uuLogin.
  87.  
  88.     Feature highlights:
  89.  
  90.         o       Up to 100  remote systems  may be defined. (more can
  91.                 be added in the future if needed).
  92.  
  93.         o       FAST execution!  Especially important for  those who
  94.                 call your system long distance.
  95.  
  96.         o       Account expirations enforced. (registered feature)
  97.  
  98.         o       Detailed logging of activities.
  99.  
  100.         o       EASY setup with the included uuSetup.Exe program!
  101.  
  102.         o       Onscreen call statistics using uuSetup.Exe.
  103.  
  104.         o       Easy system maintenance using uuSetup.Exe.
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.     ╔══════════════════════════════════════════════════════════════╗
  113.     ║▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ STARTUP ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║
  114.     ╚══════════════════════════════════════════════════════════════╝
  115.  
  116.     ┌ SETUP & INSTALLATION ────────────────────────────────────────┐
  117.     └──────────────────────────────────────────────────────────────┘
  118.     The program requires a 100%  IBM  PC compatible  computer system
  119.     running MS-DOS version 3.1 or later.   It is not compatible with
  120.     any earlier release of MS-DOS.  It requires  approximately  100K  
  121.     memory to  operate, but more  memory will increase  performance.    
  122.     When  running  external  programs from within  uuLogin, swapping  
  123.     of  the  program memory  image  to  XMS,   EMS  or disk  results 
  124.     in less than 2K  of memory being consumed  by uuLogin while  the
  125.     program  is running.  Since XMS and EMS access are significantly 
  126.     faster than disk, the  presence of  either  of  these  types  of  
  127.     memory  will  enhance performance.
  128.  
  129.     uuLogin   also runs on almost any type of MSDOS compatible local
  130.     area  network  and  specifically  supports  most  popular types,
  131.     provided that DOS SHARE.EXE is loaded prior to running.
  132.  
  133.     To  begin, unarchive all files in this package to a directory on
  134.     your hard drive. Create a subdirectory off of this directory for
  135.     uuLogin's data files called users.
  136.  
  137.     Run the program uuSetup to create the  node control  files. This
  138.     program is fully menu driven with command help  displayed on the
  139.     bottom status line for all menu options and data entry fields.
  140.        
  141.     Make sure that the directory for your uucico  program is in your
  142.     DOS path. Also make sure that you have  the environment variable
  143.     for your fx-uucico or waffle's uucico set. See the docs for your
  144.     uucico program for more details. uuLogin will shell out and then
  145.     execute  uucico with  command line parameters  telling it who is
  146.     online.
  147.  
  148.     In uuSetup, configure the remote system's information for all of
  149.     the systems that  will be calling  your system.  See the  status
  150.     line at the bottom of the screen for help in all of these fields.
  151.     You will also need to set the permits for each  remote system in
  152.     your PERMITS file.  Again,  please refer to your uucico docs for
  153.     more information.
  154.  
  155.  
  156.     ┌ COMMAND LINE ────────────────────────────────────────────────┐
  157.     └──────────────────────────────────────────────────────────────┘
  158.     Once you have properly configured uuLogin as  directed above you
  159.     will need to setup your mailer to accept calls  and transfer the
  160.     control to uuLogin. In FrontDoor and InterMail,  this is done in
  161.     ImSetup.Exe (or FdSetup.Exe). Under mailer,  choose the external
  162.     mailer definition and enter uucp as the string and set an error-
  163.     level to  drop out  to your main  batch file with.  In your main
  164.     batch file, define the errorlevel and a tag to jump to.  For the
  165.     the tag, put the following line:
  166.  
  167.                 uuLogin #
  168.  
  169.     where # is the node number for  your node that is  executing the
  170.     program. You can use environment variables here if you desire.
  171.  
  172.     Batch file example:
  173.  
  174.     :loop
  175.     c:
  176.     cd\im
  177.     im
  178.     if errorlevel 99 goto uulogin
  179.  
  180.     :uuLogin
  181.     c:
  182.     cd\waffle
  183.     uuLogin %TASK%
  184.     goto loop
  185.  
  186.     Note: you must have each  node's information  entered in uuSetup
  187.     prior to executing on a node. If all of your nodes are the same,
  188.     you can just enter  one nodes information  and then exit uuSetup
  189.     and copy the uul##.cfg file (where ## is the node number) to the
  190.     nodes you wish to establish.  Then run uuSetup again and confirm
  191.     that all of the information is correct for each node.
  192.  
  193.     You can run uuLogin alone on the  command line for a  listing of
  194.     the available options. To get version and registration info, you
  195.     can run:
  196.                 uuLogin version
  197.  
  198.  
  199.     Statistics for remote systems can be seen in uuSetup in both the
  200.     remote system setup windows and and  the statistics menu option.
  201.     The statistics menu  option will show you  summary stats for all
  202.     of the configured remote systems.  Pressing F2 at the window for
  203.     remote system  setup will  display your  remote systems that are
  204.     configured  along with  their login name,  sysop and the account
  205.     expiration dates.
  206.  
  207.     Both the node setup and remote system setup windows allow you to
  208.     press F2 to get a popup picklist of  previously configured nodes
  209.     and remote systems. You can use your arrow  keys there to choose
  210.     the node or system you wish to view or edit.
  211.  
  212.     Your remote systems will setup  their uucico  script to send the
  213.     string you defined in your mailer (uucp was suggested). And then
  214.     the balance of their script  will proceed with the login.  Below
  215.     is the  script used  that is used for  systems connecting to our
  216.     support system:
  217.  
  218.       "" \r\c Esc uucp ogin:--ogin: login_name word:--word: passwd
  219.  
  220.     Of course, you'd have them  replace login_name and passwd in the
  221.     above with the information you configured for them in uuSetup.
  222.  
  223.  
  224.  
  225.  
  226.  
  227.     ┌ COPYRIGHTS AND WARRANTIES ───────────────────────────────────┐
  228.     └──────────────────────────────────────────────────────────────┘
  229.     uuLogin   and   its   associated    documentation  and utilities
  230.     are   Copyright  1995-1996  by  Chris Stone  and  High  Mountain 
  231.     Software.   No  warranty  is made as  to  the  fitness  of  this
  232.     product for any intended purpose, nor will any responsibility be
  233.     taken for any damage,  consequential or otherwise arising out of
  234.     use  or abuse of this product.   It is provided purely on an "as
  235.     is" basis,  with no promises  or agreements regarding any future
  236.     versions or releases should they ever be published.
  237.  
  238.     This work is protected by  United States copyright  law  and  by  
  239.     the International copyright treaty.    The registered version of 
  240.     this program and its registratered key may not be re-distributed 
  241.     under any conditions and in any form. The shareware  release may 
  242.     be re-distributed under the terms and conditions of the  accomp-
  243.     anying "UULOGIN.LIC" file.
  244.  
  245.  
  246.     ┌ CREDITS ─────────────────────────────────────────────────────┐
  247.     └──────────────────────────────────────────────────────────────┘
  248.     The  author  would  like  to  thank  all  those  involved in the 
  249.     development and beta testing of uuLogin, for their help, support,
  250.     suggestions and encouragement.  Special thanks  to Aubrey Presha
  251.     for his patience and  ideas which helped  greatly in development
  252.     of this package.
  253.  
  254.     Thanks to the following for their  great products  that are used
  255.     in the development of this package:
  256.  
  257.         Borland             - for their unrivaled C compiler v4.0
  258.         Brian Piere         - for OpenDoors v5.00
  259.         Innovative Data Con.- for the TCXL, TAdv, & TFile libraries
  260.  
  261.     And a  special  THANKS  to  all of you who have  registered this 
  262.     package for supporting the shareware concept and encouraging  me
  263.     to continue development of this package!
  264.  
  265.  
  266.     ┌ SUPPORT ─────────────────────────────────────────────────────┐
  267.     └──────────────────────────────────────────────────────────────┘
  268.     Support for this package is available through the following:
  269.  
  270.     The Bailey Info Exchange BBS (303) 914-3646, (303) 838-7984
  271.         Online 24 hours a day. 300-28800 baud 8N1 v.32bis v.34
  272.         
  273.         FidoNet: 1:104/825.0  --\
  274.         FidoNet: 1:104/826.0    |
  275.         DoorNet: 75:7303/4.0    |- address to Chris Stone
  276.        PulseNet: 170:303/1.0    |
  277.         CFR-Net: 31:905/211.0 --/
  278.         
  279.     Internet: Address messages to cstone@hms.com to reach me directly.
  280.               Address messages to support@hms.com for a 24 hour auto
  281.               response message giving more details regarding support
  282.               via the internet.
  283.  
  284.     The latest release is always available via the following methods:
  285.  
  286.         File Request from: 1:104/825.0, 1:104/826.0, 75:7303/4.0,
  287.                            31:905/211.0 using the magic name UULOGIN.
  288.  
  289.         By Downloading from The Bailey Info Exchange BBS at the phone
  290.         numbers listed above.
  291.  
  292.         Anonymous ftp: ftp.csn.net/hms
  293.  
  294.         World Wide Web: http://www.hms.com/hms, and
  295.                         http://www.dimensional.com/~cstone
  296.  
  297.         By Downloading from numerous other BBS sites around the world.
  298.         Check your local systems.
  299.  
  300.  
  301.     ┌ REGISTRATION ────────────────────────────────────────────────┐
  302.     └──────────────────────────────────────────────────────────────┘
  303.  
  304.     Please see the included file UULOGIN.LIC for further information.
  305.  
  306.  
  307.